File formats

Fixture plan file format (*.csv)

The fixture plan file format is versioned to ensure that CSV files generated for Designer 1.7.x and later will be imported into any version of Designer from 1.7.0 onwards. Version information must be added to the first line of the CSV file as follows:

#version=2

The current version is 2.

Lines starting with # are comments and are ignored (except the version line). Blank lines are ignored.

Fixture type syntax

@[manufacturer id],[model id](,[mode id])

where [manufacturer id] and [model id] are the numbers which can be found in the fixture's identification fields in Setup. [mode id] is optional, leaving it out assumes mode 0 or that it is irrelevant.

The fixture type must be specified before any fixture position line(s)
Multiple fixture type lines can appear consecutively in a file for batches of different fixture types

Fixture position syntax

[fixture number],[name],[x position],[y position],[rotation angle],[width],[height],[comment 1],[comment 2]

where [fixture number], [x position], [y position], [rotation angle], [width] and [height] are mandatory numbers and [name], [comment 1] and [comment 2] are strings which may be left blank. [rotation angle] is specified in degrees, clockwise from vertical.

Fixture position lines must be specified after a fixture type line
Fixture numbers must be unique in the file and must not already exist in the project
The plan will be resized to accommodate the fixture positions, after getting confirmation that it is alright to do so

Example

# LEDs

@0,5

1,,0,0,0,50,50

2,,30,0,0,50,50

3,,60,0,0,50,50

4,,90,0,0,50,50

# Dimmers

@0,0

100,,100,100,0,25,25

101,,125,100,0,25,25

102,,100,125,0,25,25

103,,125,125,0,25,25

Pixel matrix file format (*.csv)

The pixel matrix file format is versioned to ensure that CSV files generated for Designer 1.9.x and later will be imported into any version of Designer from 1.9.0 onwards. Version information must be added to the first line of the CSV file as follows:

#version=1

The current version is 1.

Lines starting with # are comments and are ignored (except the version line). Blank lines are ignored.

Fixture position syntax

[fixture number](.[fixture element index]),[x position],[y position],[rotation angle]

where [fixture number], [fixture element index], [x position] and [y position] are numbers. [rotation angle] is optional (not valid for single-element fixtures) and is specified in degrees, clockwise from vertical. The fixture element index is only required if the fixture specified by fixture number is a compound fixture.

NOTE: On a matrix, a fixture's position is where the first element of the unrotated fixture lies. Fixtures are rotated about their center. Therefore a rotated fixture will appear to have a different position to that given in the imported file.

Example

# Simple matrix

1,0,0

2,30,0

3,0,30

4,30,30

5.1,0,60

5.2,30,60